home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
system
/
alarm400.zip
/
ALARM.DOC
< prev
next >
Wrap
Text File
|
1987-10-11
|
22KB
|
471 lines
ALARM : Alarm Clock Program and Utilities
Version 4.00, 11-Oct-1987
SMG Software
(C) Copyright 1986,1987 by
Steven Georgiades
All Rights Reserved
Table of Contents
-----------------
I. Overview ........................... Page 2
II. Program Installation and Usage ..... Page 3
III. The ALARM Configuration File ....... Page 5
IV. Revision History ................... Page 6
V. Additional Utilities ............... Page 7
VI. Program Restrictions ............... Page 7
VII. Program License .................... Page 8
VIII. Program Registration ............... Page 8
IX. Disclaimer ......................... Page 9
X. Reporting Problems ................. Page 9
1
ALARM, Version 4.00 Page 2
I. OVERVIEW
The ALARM program provides a memory resident alarm clock with
eight different alarms, each of which can be set to go off at a
different time of day. This is useful to signal the user about a
meeting, a lunch date, or an appointment. ALARM also has four
reminders, which can be set to go off at different time intervals.
These are useful for reminding the user to perform periodic tasks, such
as doing saves while editing, or taking medication. Each of the eight
alarms and four reminders may have a user-defined message associated
with it, up to 32 characters in length. When the alarm time is reached
(or when the reminder interval has expired), the computer's current
activity will be suspended, and a window will appear in the middle of
the screen indicating the alarm or reminder number, the current time,
and the corresponding message. In addition, a musical tune will be
played, as specified in the alarm configuration file. Using the
supplied tune-files and configuration file (ALARM.CFG), these tunes
will be as follows:
Alarm #1 : Funeral March of the Marionettes
Alarm #2 : Carnival
Alarm #3 : Holiday Road
Alarm #4 : When The Saints Go Marching In
Alarm #5 : Fur Elise
Alarm #6 : O' Solo Mio
Alarm #7 : Turkey in the Straw
Alarm #8 : Aura Lee
Reminder #1 : Oh! Susanna
Reminder #2 : London Bridge
Reminder #3 : Mary had a Little Lamb
Reminder #4 : Yankee Doodle
Note that upon installation, the message associated with each alarm or
reminder is set to the title of the corresponding tune. In all cases,
a tune can be terminated before completion by pressing the Escape key.
Once an alarm or reminder has sounded, the window will disappear
immediately, unless it was set to persist. In this case the window will
remain (persist) on the screen until the Escape key is pressed. If a
second alarm time should be reached before the Escape key is pressed,
that alarm will supersede the first, and the first one will be aborted.
In addition to alarms and reminders, the ALARM program also has
Westminster chimes which can be enabled to sound on the hour, half-hour
or quarter-hour. The chimes can also be disabled.
A facility is also included to disable the ALARM program
completely. This is useful when executing programs which may be
adversely affected by a pop-up window, such as FORMAT or disk
optimizing software.
ALARM, Version 4.00 Page 3
II. PROGRAM INSTALLATION AND USAGE
In order for the ALARM program to work, it must first be installed
as resident in memory. This is accomplished by one of the following
commands:
ALARM I or ALARM Ifilename.ext
The first form will look for the default configuration file, ALARM.CFG,
in the current directory. If not found, ALARM will use no
configuration data and will install a very simple (and very boring)
form of the program, with "beeps" instead of tunes. The second form
will look for the specified configuration file. If not found, an error
will be flagged. Note that the filename may optionally include a drive
letter and/or a path specification. For more information on the ALARM
configuration file, see section III, below.
Once installed in memory, three sub-systems are available: Alarms,
Reminders, and Chimes. The Alarms Sub-System consists of eight alarms,
which may be set by issuing one of the following commands:
ALARM An=hh:mm or ALARM An=hh:mm/"msg"
ALARM An=*hh:mm or ALARM An=*hh:mm/"msg"
where "n" is the alarm number (1 to 8), "hh:mm" is the alarm time, in
24-hour format (5:00 pm is 17:00), and "msg" is an optional alarm
message which may be up to 32 characters in length. If "msg" is
omitted, as in the left column above, then the alarm message remains
unchanged. If an asterisk ("*") is specified with the alarm time, as
in the bottom row above, then that alarm is set to persist. Individual
alarms may be enabled, disabled, queried, and tested, respectively, by
entering the following commands:
ALARM An+ ALARM An- ALARM An? ALARM AnT
Disabling an alarm will not change it's setting. When it is once again
enabled, it will still be set to the same time as before it was
disabled. Note that the act of setting an alarm enables it. The query
option will list the alarm number, the current setting (or OFF if
disabled), and the current message associated with that alarm. Testing
an alarm will cause an alarm window to pop up and the tune to be
played, just as if the alarm time had been reached. This will work
regardless of whether the specified alarm is enabled.
In addition to this, the entire Alarms Sub-System may be enabled,
disabled, or queried, as follows:
ALARM A+ ALARM A- ALARM A?
Disabling the Alarms Sub-System will disable all eight alarms. This is
different from disabling all eight alarms individually, since disabling
and re-enabling the Alarms Sub-System will preserve the enable/disable
status of each alarm. Querying the Alarms Sub-System is equivalent to
querying each of the eight alarms individually.
ALARM, Version 4.00 Page 4
II. PROGRAM INSTALLATION AND USAGE (Continued)
The Reminders Sub-System behaves virtually the same as the Alarms
Sub-System, the only major difference being that a Reminder Interval
("mm") must be specified, instead of an Alarm Time ("hh:mm"). The
reminder interval may be from 1 to 255 minutes. Note that there are
only 4 reminders, so "n" must be in the range 1 to 4. To set a
reminder, use the following commands:
ALARM Rn=mm or ALARM Rn=mm/"msg"
ALARM Rn=*mm or ALARM Rn=*mm/"msg"
To enable, disable, query or test individual reminders, use the
following commands:
ALARM Rn+ ALARM Rn- ALARM Rn? ALARM RnT
To enable, disable